home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / haeberli / mpeg / mpeg_play.man < prev    next >
Text File  |  1994-08-01  |  6KB  |  157 lines
  1.  
  2.      MPEG_PLAY(1)     UNIX System V (27 January 1993)     MPEG_PLAY(1)
  3.  
  4.      NAME
  5.           mpeg_play - plays mpeg-1 encoded bitstreams using X11
  6.  
  7.      SYNOPSIS
  8.           mpeg_play [ -nob ] [ -nop ] [ [ -display display_name ] [ -
  9.           dither dither_option ] [ -loop ] [ -eachstat ] [ -no_display
  10.           ] [ -shmem_off ] [ -l_range num ] [ -cr_range num ] [ -
  11.           cb_range num ] [ -quiet ] file_name
  12.  
  13.      DESCRIPTION
  14.           mpeg_play decodes and displays mpeg-1 encoded bitstreams on
  15.           systems running X11.  The player will create a new window,
  16.           display the bitstream, and exit.  Any error messages or
  17.           notices are sent to stderr.
  18.  
  19.      OPTIONS
  20.           -nob : causes the player to ignore and not display any B
  21.                frames.
  22.  
  23.           -nop : causes the player to ignore and not display any P
  24.                frames.
  25.  
  26.           -display display_name : causes the player to open the window
  27.                on the display display_name.
  28.  
  29.           -dither dither_option : selects from a variety of dither
  30.                options. The possible values are:
  31.  
  32.                ordered - ordered dither.
  33.  
  34.                ordered2 - a faster ordered dither. This is the
  35.                     default.
  36.  
  37.                mbordered - ordered dithering at the macroblock level.
  38.                     Although there is a noticeable decrease in dither
  39.                     quality, this is the fastest dither available.
  40.  
  41.                fs4 - Floyd-Steinberg dithering with 4 error values
  42.                     propogated.
  43.  
  44.                fs2 - Floyd-Steinberg dithering with 2 error values
  45.                     propogated.
  46.  
  47.                fs2fast - Fast Floyd-Steinberg dithering with 2 error
  48.                     values propogated.
  49.  
  50.                hybrid - Hybrid dithering, a combination of ordered
  51.                     dithering for the luminance channel and Floyd-
  52.                     Steinberg 2 error dithering for the chrominance
  53.                     channels. Errors are NOT propogated properly and
  54.                     are dropped all togethor every two pixels in
  55.                     either direction.
  56.  
  57.      Page 1                                          (printed 6/29/94)
  58.  
  59.      MPEG_PLAY(1)     UNIX System V (27 January 1993)     MPEG_PLAY(1)
  60.  
  61.                hybrid2 - Hybrid dithering as above, but with error
  62.                     propogation among pixels.
  63.  
  64.                2x2 - A dithering technique using a 2x2 pixel area for
  65.                     each pixel. The image displayed is 4 times larger
  66.                     than the original image encoded. Random error
  67.                     terms are added to each pixel to break up contours
  68.                     and gradients.
  69.  
  70.                gray - Grayscale dithering. The image is dithered into
  71.                     128 grayscales. Chrominance information is thrown
  72.                     away.
  73.  
  74.                color - Full color display (only available on 24 bit
  75.                     color displays).
  76.  
  77.                none - no dithering is done, no image is displayed.
  78.                     Used to time decoding process.
  79.  
  80.                mono - Floyd-Steinberg dithering for monochrome
  81.                     displays.
  82.  
  83.                threshold - Floyd-simple dithering for monochrome
  84.                     displays.
  85.  
  86.           -loop : makes the player loop back to the beginning after
  87.                reaching the end.
  88.  
  89.           -quiet : supresses printing of frame numbers, timing
  90.                information, and most error messages.
  91.  
  92.           -eachstat : causes statistics to be displayed after each
  93.                frame. Only valid when compiled with -DANALYSIS.
  94.  
  95.           -shmem_off : turns shared memory off.
  96.  
  97.           -l_range num_colors : sets the number of colors assigned to
  98.                the luminance component when dithering the image.  The
  99.                product of l_range, cr_range and cb_range should be
  100.                less than the number of colors on the display.
  101.  
  102.           -cr_range num_colors : sets the number of colors assigned to
  103.                the red component of the chrominace range when
  104.                dithering the image.  The product of l_range, cr_range
  105.                and cb_range should be less than the number of colors
  106.                on the display.
  107.  
  108.           -cb_range num_colors : sets the number of colors assigned to
  109.                the blue component of the chrominace range when
  110.                dithering the image.  The product of l_range, cr_range
  111.                and cb_range should be less than the number of colors
  112.                on the display.
  113.  
  114.      Page 2                                          (printed 6/29/94)
  115.  
  116.      MPEG_PLAY(1)     UNIX System V (27 January 1993)     MPEG_PLAY(1)
  117.  
  118.           -no_display : dithers, but does not display, usually used
  119.                for testing and timing purposes.
  120.  
  121.      NOTES
  122.           The player expects MPEG-1 video streams only. It can not
  123.           handle multiplexed MPEG streams or video+audio streams. The
  124.           player uses the paris entropy coding table set (which we
  125.           believe to be the MPEG-1 standard), but can not handle any
  126.           bitstreams that use the "berlin" entropy coding table set.
  127.           Berlin data is relatively rare so there shouldn't be too
  128.           much to worry about here, but be aware of the difference
  129.           when looking for streams to play.
  130.  
  131.           Some streams do not end with the proper sequence end code
  132.           and will probably generate an "Improper sequence end code."
  133.           error when done playing.
  134.  
  135.           This player can play XING data files. Be aware that XING
  136.           makes no use of temporal redundancy or motion vector
  137.           information. In other words, they do not use any P or B
  138.           frames in their streams. Instead, XING data is simply a
  139.           sequence of I frames. Since I frames take significantly
  140.           longer to decode, performance of the player using XING data
  141.           is not representative of the player's ability.
  142.  
  143.      AUTHORS
  144.           Ketan Patel - University of California, Berkeley,
  145.                kpatel@cs.berkeley.edu
  146.  
  147.           Brian Smith - University of California, Berkeley,
  148.                bsmith@cs.berkeley.edu
  149.  
  150.           Henry Chi-To Ma - University of California, Berkeley,
  151.                cma@cs.berkeley.edu
  152.  
  153.           Kim Man Liu - University of California, Berkeley,
  154.                kliu@cs.berkeley.edu
  155.  
  156.      Page 3                                          (printed 6/29/94)
  157.